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- INTRODUCTION 


SHARP APL forms a good general base for an interactive graphics system. It handles complex parallel computation 
and provides a simple, efficient file system. The highly interactive nature of APL allows rapid development of new 
user systems. Feedback is immediate, in contrast to the hours or days typical of a traditional batch/line-printer/ 
plotter approach. 


The SHARP APL graphics package is a tool for two-dimensional and three-dimensional line drawing on a wide 
variety of CRT, hard-copy and plotter terminals. 


The functions fall into the following categories: 


1), Terminal Drivers, the terminal-dependent functions that perform graphic input and output. 

2) Transform, object, and string generators: these generate the graphic data structures used by 
graphics. 

3) Transform applicators: functions that transform pictures by such means as scaling, translation, 


rotation, clipping, changing pens or type font, boxing, and so on. 


4) APL-like functions: these functions manipulate graphic data structures in a manner analogous to 
APL. 
5) Utility functions: functions commonly used in graphics but falling into none of the other groups. 


SHARP APL graphics differs from most other APL-based graphics systems in that it allows an object (picture), 
text string, or transform, to be treated in a manner similar to an APL scalar. This allows creation and manipulation 
of entire collections of objects at once. 


The reader is expected to be well versed in APL, and should have a terminal handy to try the examples as they occur 
in the text. 


Workspace 3 GRAPHICS contains the documented versions of the graphics functions. Workspace 3 GRAFIX 
contains compressed versions (without comments) of the same functions. 


Note that both workspaces are origin 1 dependent. 
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SECTION I 
STARTING OUT 


In order to introduce the user to some of the capabilities (and fun) of the SHARP APL graphics system quickly, 
a selection of the available functions is discussed in this section in the following sequence: 


Making an object, 
Drawing the object, 
Manipulating the object, 
Decorating the object. 


SECTION H contains detailed explanations of all functions. 





The object of any graphics system is to produce a picture that can be drawn on a terminal screen or paper, seen from 
different angles, added to, clipped to fit the screen or any other boundaries, and moved about. 


Before we start, we have to define the space in which our object rests and the size of the object in terms of its universe 


UNIVERSE, VIEW, WINDOW 


In graphics the universe is a Cartesian N -space, typically 2-space (two-dimensional) or 3-space (three-dimension- 
al). Points and line segments can be drawn in this empty space. Any set of points and/or line segments in space can 
be logically grouped together to form an object. SHARP APL graphics can be used to construct and manipulate 
objects in the universe. 


The user views the universe through a window bounded by the edges of a physical or logical screen. The global 
‘transform TRANS controls the position of the window in relation to the user's space. TRANS maps the user space 
into a square window of radius 1 with its origin in the centre of the window. 
The default value of TRANS is: 

TRANS+SCALE+10 
which results in a user space oriented so that the origin (X,Y=0,0) is at the centre of a window with a radius of 
10 units. The view through the window is clipped to match the aspect ratio of a rectangular screen (half of the longer 
side is 10 units). 


The global variable CTRANS may be used to divide the physical screen logically into several frames. 


The global variable SMTRANS describes the terminal and should not be altered by the naive user. 








BEGINNER’S VOCABULARY 


These abbreviated definitions touch on some of the more important concepts of the SHARP APL graphics package. 
APPENDIX A (GLOSSARY page 117) expands on these definitions and SECTION II (page 47) contains 


detailed text. 


Object 


Graphic Vector 


Text 


Box 


Transform 


An object is a collection of point and/or line segments in space. An object is 
treated as an entity by the graphics system, in much the same manner as a 
scalar is treated by APL. An object may be thought of as a graphic scalar or 
a one-element vector. The APL representation of a graphic object, however, 
is a matrix. The matrix consists of controls and the cartesian coordinates of 
the points that define the object. Each row defines a point. Column 1 is 
reserved for object delimiters and pen controls. Columns 2 and 3 specify the 
X and Y coordinates of the object. For three-dimensional objects a fourth 
column is needed to specify the Z-axis coordinates. Higher dimensional 
objects may be created and most transform applicators will properly manipu- 
late them. 


Zero or more objects, catenated (joined together) along the first coordinate, 
form a picture or graphic vector. Most graphic functions treat a picture made 
up of N objects as an N-element vector. 


Text is represented in graphics as a vector of character strings. A set of 
APL-like functions manipulate character string vectors, as they do graphic 
vectors. The more commonly used APL characters are supported both as 
hardware (e.g. terminal-generated ) and as stroke (drawn) characters. Hard- 
ware characters will vary depending on the hardware used. Stroke characters 
look better and are more expensive than hardware characters. 


A box may be created to contain a graphic object or text. Boxes provide an 
easy and convenient way to move pictures around, or place text. A box may 
be used as a “window” or “viewport” just as the screen boundaries of a TV 
monitor act when the camera zooms in on an object. 


There are two ways in which graphic vectors, once created, can be manipu- 
lated. The data structure itself can be changed using APL-like functions such 
as TAKE’, DROP, and COMP (compress) to add, remove, substitute and 
combine objects. Alternatively, the picture described by the graphic vector can 
be scaled, rotated, or translated in the space in which it is defined by the use 
of transforms. Combinations of scaling, rotational and translational trans- 
forms are also possible. Transforms may be described in terms of a camera: 
scale (zoom), translate (reposition or move) and rotate (tilt or pan). 





THE TERMINAL 


Most graphic input functions are terminal dependent. Input functions are provided for Tektronix 4000 and Hewlett/ 
Packard 2648A series crosshair input “Gin mode”, and the Tektronix 4953 graphic tablet. Most non-CRT terminals 
do not support graphic input at all. 


The following terminal types are supported (today). To condition the workspace, type: TERM 'code', where 
code is one of the codes given below. For example, when using any Tektronix 4000 series terminal, the first 
commands after signing on would be: 


)LOAD 3 GRAPHICS 


TERM "TEK! 
Terminal Code 
Any Tektronix 4000 series terminal TEK 
Tektronix 4013 TEK4O13 
Tektronix4015 TEKĄ4015 
Anderson- Jacobson A J832 AJ 832 
Xerox Diablo model 1550 DIABLO 
Xerox Diablo 1620 DIABLO 
Xerox Diablo 1700 NEWD1700 
DTC300 DTC 300 
DTC302 DTC302 
Trendata 4000 TREN4000 
Trendata 4000A TRENYOOOA 
Multiwriter II ASL2 
Multiwriter III ASL3 
Tektronix 4662 Plotter T4662 
Houston Instruments Plotter HIPPO 
Hewlett/Packard 7221A HP7221 
Hewlett/Packard 9221A HP9221 
Spintronic SPIN2 
Mitek MITEKV3 


To obtain an updated list of supported terminals and their codes, type TERM ''. 


Terminal-specific strapping and setup requirements are documented in the OUTTERM function, created by successful 
execution of the TERM function. 


Supporting new terminal types is rather easy, as there is only one terminal-dependent output function (called 
OUTTERM) in the workspace. Thus, one can run the same set of functions on a different terminal by executing the 


TERM function to define the OUTTERM function necessary for the terminal in use. 


The illustrations in this manual were produced on a Tektronix 4015 with a 4631 hardcopy attachment. 








GRAPHIC INPUT 
Objects can be generated in many ways: by hand using APL primitives, using object generator functions, by means 
of interactive crosshair input or the graphics tablet, and from user functions. 


Zero or more objects catenated along the first coordinate form a picture (graphic vector). You will recall that graphic 
vectors are matrices, with each row defining a point of the object, and the columns defined as follows: 


Column 1 Controls ( 4 for object delimiter,1 for draw, O for move - see 
APPENDIX A on page 119 for other options) 

Column 2 X coordinate | 

Column 3 Y coordinate 

Column N N-1’th coordinate. 


1) Generating an Object By Hand. 
EXAMPLE: $ 
(a) Generate a unit square with the default unit being 1/20th screen width (the screen radius is 10). Notice that 
the coordinates of the first and last points are equal, to produce a closed figure. | 
OBJ1+5 3p 4 0 0 110 LĄ 101 1.0.0 


OBJ1 


hhh 
O O A PO 
O RE AOO 


DRAW OBJ 1 





(b) A triangle in two dimensions. 


OBJ2+4 30400 12 


OBJ 2 


ha 
© APO 
ONE O 


DRAW OBJ 2 


(c) Now create a graphic vector. 
GV+<OBJ 1 „[1 ]OBJ2 


GV 


l 
PRR FP PRP FE 
OrFDOOOHrLRO 
ONROOHRHROO 


DRAW GV 











(d) 


Graphic vectors may be built by the user with simple (or not so simple) APL expressions, for instance the 
sine curve. 


EXAMPLE: 


GV2<1,(( 181+1361)+18),[1.5]5x10(1361)x0+180 
NOTE: The global variable OD is a vector of controls defining a set of 


object delimiters. Default is 4 2 (object delimiter, point 
plot object delimiter). Therefore: 


GV2[1;1 ]<1pOD 


DRAW GV2 








2) Using object generator functions provided by SHARP APL graphics. All graphic input functions generate 
graphic vectors. See the discussion of input-output functions in SECTION II-A (page 48). 


(a) The function MO (Make Object) generates an object from numeric data. 
FUNCTION: MO 
SYNTAX: GV<MO XY 
RIGHT PARAMETER XY: - If XY is a scalar, vector, or a 1-column matrix, (1p,XY) will 


be catenated as X coordinates, with XY becoming Y coordinates. 
Appropriate controls are added to draw all points. 


- If 2sppXY then XY is restructured to be 
(2t(oXY),1 1)pXY. Appropriate controls are then added 
to draw all points. 


EXAMPLES: MO is handy for plotting - see page 48 for more. 


U+-DATA<.1x10750 
le). 252 056: 2:0 0437 828 05 © war As 


DRAW MO DATA 


To ensure that the plot fits on the screen, just put the resulting object in a box: 


DRAW BOX BX< 1 1 1 1 x6 DRAW (MO DATA) INBOX BX 
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(b) Polygons 


FUNCTION: POLY 

SYNTAX: | | GV<l1 POLY N2 

LEFT PARAMETER N1: Scalar or vector specifying the number of sides to the poly- 
gon(s). 

RIGHT PARAMETER 22: Radii of the polygons. 

NOTES: (SHAPE GV)=(pN1)[ pN2 


The shorter argument is extended using RESHAPE. 


EXAMPLES: 


Triangle of radius 1. 
DRAW 3 POLY 1 





Triangle of radius 2 and diamond radius 1. 
DRAW 3 4 POLY 2 1 
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(c) 


Daisies and stars 
FUNCTION: 
SYNTAX: 


LEFT PARAMETER N1: 


DRAW (2 2p3 3 18 6) DAISY 1 3 


Points Petals 
3 3 
18 6 


RIGHT PARAMETER 22: 


NOTES: 


DAISY 

GV<N1 DAISY N2 

Number of data points per daisy and number of petals per 
daisy. V1 may be a scalar, a 2-element vector, a one-column 


matrix, or a two-column matrix. A scalar argument is extended 


with RESHAPE. See Section II-A (page 50) for details. 


Radii of daisies. V2 may be a scalar or a vector. When building 
more than one daisy, V2[ 7 | is the size of the Pth daisy. 


(SHAPE GV)=(pN2)l1tpN1 
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EXAMPLES: 





DRAW 5 DAISY 2 


DRAW 100 5 DAISY 2 

















3) 


(a) 


Interactive Input is supported on the Tektronix 4013/4015 and Hewlett/Packard 2648A. 


Crosshair input via the function XIN allows the user graphic input via crosshairs, and returns a graphic 
vector in the user's coordinate system. See SECTION II-A (page 52) for a detailed explanation. 


FUNCTION: 


SYNTAX: 


LEFT PARAMETER CH: 


RIGHT PARAMETER J: 


NOTE: 


EXAMPLES: 


'NPLC' XIN 20 





XIN 
GV<CH XIN N 
Acceptable input characters. 


Maximum number of points allowed to complete the picture 
(0 is no limit). 


Blank terminates input prematurely. 

Carriage return, break, or other ASCII control characters give 
unpredictable results. | 

Required terminal strapping is documented in the OUTTE RM 


function. 


will create a graphic vector with a maximum of 20 points in 
the picture. Acceptable input characters are V, P, L, and 
C. The value of an input control generated by an input char- 
acter is determined by its origin O index in CH. Thus the 
controls produced by N,P,L and C are 0,1, 2 and 3 respec- 
tively. 


16 








(b) Crosshair input: the function FOLLOW performs sketch-pad input. It is similar to XIN but the resulting 


graphic vector is drawn as it is generated. 


FUNCTION: 


SYNTAX: 


NOTES: 


EXAMPLES: 


A<FOLLOW 


FOLLOW 
GV<FOLLOW 


Input control characters on the Tektronix keyboard are: 
Numerics used directly as controls: 
0,2,4,6,8 = Move to crosshairs 
1,3,5,7,9 = Draw to crosshairs (from previous 
point). 
N Begin new object (i.e. CONTROL is 1pOD ) 
P Draw to nearest point 
L Draw to nearest line 
C Circular arc through previous, current and next 
points. 


Crosshairs appear on the screen. Move the crosshairs and key 
in control characters as necessary to register points. Typical 
output using this technique is the drawing below. 


SECTION II-A (page 52) contains explanations of the other functions in this group. APPENDIX B (page 


125) contains an index of functions. 
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(c) Graphics tablet - pen input on the Tektronix 4953 only. Plugging requirements are documented in the 
TABLET function. 


FUNCTION: TABLET 
SYNTAX: GV+TABLET N 
RIGHT PARAMETER W: If N=0: Point to point input (connect the dots); each push of 


the pen inputs one point. Removing the pen from the 
tablet terminates input. The result is a single object, 
containing as many points as there are pen pushes. 


If N=1: Continuous input (curve or feature tracing). Points 
are input at several points per second for as long as 
the pen is pushed. Each pen push produces an object 
delimiter, allowing several features to be entered at 
once. The result contains as many objects as there are 
pen pushes. 


EXAMPLES: 


2 
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1) Drawing Graphic Objects 


GRAPHIC OUTPUT 


As seen in the previous examples, DRAW draws graphic vectors (as opposed to text). 


FUNCTION: 
SYNTAX: 


RIGHT PARAMETER GV: 


Drawing from Files 
SYNTAX: 


RIGHT PARAMETER F: 


DRAW 
DRAW GV 


If the graphic vector to be drawn is an Nx3 matrix, it is clipped 
to the screen boundaries, and drawn. 


DRAW F 


If F is a vector, read and draw the components 14F' from the 
file tied to 1tF. 


If F is a scalar or one-element vector, read and draw all compo- 


nents of the file tied to F. Character components and packages 
are ignored. 
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2) 


Drawing Text 
FUNCTION: 
SYNTAX: 


LEFT PARAMETER Bx: 


RIGHT PARAMETER SV: 


EXAMPLE: 


DRAWSTR 
BX DRAWSTR SV 


Zero or more boxes to set the boundaries for the text te be 
drawn. For example, BX may be a rectangle with the bottom 
left-hand corner at screen coordinates (0,0) and the top right- 
hand corner at the point (1,5). BX would be defined as follows: 
BX*0 0 1 5 


Text string vector. Strings are delimited by the first character 
in the first string. The first character after each string delimiter 
is the type font (for example, on all terminals, 0 is APL 
hardware characters, and 8 and 9 are stroke or drawn char- 
acters ). | 


See SECTION II-A (page 56) for more details on SV. 


Each string in SV is drawn such that the first character in the 
string is located at the upper left-hand corner of the box. Stroke 
characters are scaled to fit the box. 


(3 4p0 0 5 1) DRAWSTR '/0OONE/8TWO/2THREE" 


T WC 


The other functions in the group Input-Output functions, (TEXT, VTEXT, STR for text output), are discussed 
in more detail in SECTION II-A (page +8). See Appendix B (page 125) for a complete list of functions in this 


group. 
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MANIPULATING OBJECTS 


The essence of interactive graphics lies in the way the user can manipulate each picture, or part of a picture. Objects 
can be transformed, or they may be manipulated via APL-like functions. They may subsequently be decorated, 
placed on file, flipped, and otherwise abused. 


Transforms that will rotate, scale, or translate (reposition) the picture are discussed in detail in SECTION II-B 
(page 77). The two transforms that appear in the following sessions at the terminal are translation, via the function 
I AX, and rotation via the function JAR. 


This chapter and the session at the terminal that follows, introduce the capabilities of the system. SECTIONS II-B 
(page 77) and II-C (page 91) should be read carefully for an understanding of transforms and APL-like 
manipulations. APPENDIX A (page 117) contains short definitions and APPENDIX B (page 125) lists all 


functions in a reference card format. 


The APL-like functions demonstrated on the following pages are: 

TAKE, DROP, COMP (compress), MOS (make object scalar), PMOS (partitioned MOS), SHAPE (monadic 
p for graphic vectors), ISHAPE (itemwise SHAPE), NDXG (index generator), and an object decorator from 
the group HATCH. SECTION II-C (page 91) contains discussions of all functions in this group. 


The text placement function TEXT and object generator DAT SY are also demonstrated. 
The following sessions at the terminal show some of the capabilities of the SHARP APL graphics package. An object 


is generated and manipulated first by means of APL-like functions, and then by transforms. The user is encouraged 
to try the manipulations on a series of objects. 
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SESSION 1 


)LOAD 3 GRAFIX 
SAVED 00.58.17 18/11/77 


TERM 'TEK! 


A+3 4 5 POLY 14 
DRAW A | 


© 
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DRAW 1 TAKE A 





24 


DRAW 3 DROP A 





26 





DRAW 1 0 1 O COMP A 
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DRAW 1 TAKE 1 0 1 0 PMOS A ACONTROLLED RAVEL 
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DRAW A IAX 5 aTRANSLATION IN ONE DIMENSION 


Centre ' | 
Screen 
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DRAW A IAX 5 2 ATRANSLATION IN MULTIPLE DIMENSIONS 
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DRAW A TAX 2201340 AITEMWISE TRANSLATION BY OBJECT 
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Number each point in A. Dropping the controls from A leaves us with the coordinates of each point. 


PTS+114pA 


DRAW A © (O 1 +A) TEXT ,'</0>,L14* QFMT PTS 
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Number each point in A, by object. 


A+-(2+14) POLY 14 
PTS+NDXG 1,[1.5] ISHAPE A 


DRAW A © (O 144) TEXT „'</0>,LI4' (FMT PTS 
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Approximations of circles. 
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Point plot circle (make each DRAW control a point plot control). 


A[1+ 14114%p4;1 ]+2 
DRAW A 
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Ellipses are just misshapen circles. 


DRAW A+(15 POLY 1) IAS 2 2p1 2 5 3 
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| Mandalas. 


DRAW A+15 5 DAISY 7 
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A (the daisy above), is rotat 


Object 





DRAW A IAR 4x118 
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Translation first, then rotation. 


DRAW (A IAX 3) IAR 12x130 
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Almost any shape rotated about the origin will form a more or less pleasing mandala. 
Try: 


DRAW A<FOLLOW 
DRAW A IAR 20x118 
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SESSION 2 


Draw a picture at a series of points X. 


DRAW (50 5 DAISY 14) IX 4 20 5 5 1 13370 


a EE” a” 














Draw a picture at each point of another picture. 


DRAW (5 DAISY 1) IAX 0 147 DAISY 5 
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Draw a picture at the first points of another set of pictures: 
A<(3 POLY 15) IAR 5?360 
DRAW (5 6 DAISY .1) IAX A[BEGN A;2 3] © DRAW A 
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Place a star at all points (100 maximum) specified by the crosshairs on the Tektronix terminal using the function 


XIN. 


DRAW (5 5 DAISY „1) IAX O 14'01' XIN 100 
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GV 
TRF 
XL 
SCL 
RU 


CH 
SV 
XY 


FNAME 
BX 


SECTION II 


TEXTBOOK 


Detailed descriptions of all the functions, their syntax, and examples. 


KEY TO ABBREVIATIONS 


a graphic vector i.e. zero or more objects 

zero or more transforms 

translation amounts 

scaling amounts 

rotational units 

numeric data 

character data 

text string vector (substrings delimited by 1+SV) 
cartesian data 

Boolean partition vector, (ones start each partition); or Boolean compression /expansion vector 
file tie number, component-number vector 

file name 

zero or more boxes!s 
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_ GRAPHIC INPUT 

(a) Make Object 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


RIGHT PARAMETER XY: 


EXAMPLES: 
E MO 3.1 
w <q Bd 

MO .1+13 
"R. 1 1.1 
4 79: 24 
t 3: 24 
7 MO 3 2p0.1+16 
ik de 234, - 
i 31 3:9 
1 5.1 6.1 





SECTION II-A 


INPUT-OUTPUT FUNCTIONS 


MO 
GV<MO XY 


Generates an object from the numeric data XY. MO is handy 
for plotting (see page 10). 


- If XY is a scalar, vector, or a 1-column matrix, (19 ,XY) will 
be catenated as X coordinates, with XY becoming Y coordinates. 
Appropriate controls are added to draw all points. 


E If 2<ppXY, XY 1S restructured to be 


(24(pXY),1 1)pXY. Appropriate controls are added to 
draw all points. 
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(b) 


Polygons 

FUNCTION: 

SYNTAX: 

DESCRIPTION: 

LEFT PARAMETER M1: 
RIGHT PARAMETER N2: 
NOTE: 

EXAMPLES: 


DRAW 3 POLY 13 


DRAW 3 4 5 POLY 13 


POLY 

GV<N1 POLY N2 

Generates polygons. 

Number of sides to the polygons. 
Radii of the polygons. 


(SHAPE GV)=(pN1)[pN2 
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(c) 





Daisies and stars 
FUNCTION: 
SYNTAX: 
DESCRIPTION: 


LEFT PARAMETER M1: 


RIGHT PARAMETER 22: 


NOTE: 


DAISY 

GV+N1 DAISY N2 

Generates daisies and stars. 

Number of points and number of petals. N1 may be a scalar, 
a 2-element vector, a one-column matrix, or a two-column 
matrix. 

- If N1 is a scalar, DAISY generates one star with N1 points. 
- If N1 is a two-element vector, the first element specifies the 
number of points that should be used to draw the daisy. The 
more points, the smoother the curve. The second element defi- 
nes the number of petals. 


- If N1 is a matrix, multiple stars and daisies are generated: 


- One-column matrix: N[ I ; ] is the number of points on the 
Pth star - and must be odd-numbered. 


- Two-column matrix: 1tpN1 is the number of daisies to be 
built. 
N[I;1] is the number of points on the Pth daisy, 
N[I;2] is the number of petals on the Ith daisy. 


If both values are the same, an V1[7;2 |] pointed star is built. 


Radius of the daisy. N2 may be a scalar or a vector. When 
building more than one daisy, V2[ 1] is the radius of the [th 
daisy. 


(SHAPE GV)=(pN2)[ 1tpN1 
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(d) 


(d) 1 


Interactive input 


Crosshair input is supported only on certain terminals, (the Tektronix 4013 /4015 and the Hewlett/Packard 


2648A). 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


LEFT PARAMETER CH: 


RIGHT PARAMETER W: 


NOTES: 


EXAMPLES: 


"NOLC' XIN 20 





XIN 


"'GV+<CH XIN N 


Crosshair input on the Tektronix 4000 series and the Hewlett / 
Packard 2648A. 


Acceptable input characters. 


The maximum number of points allowed to complete the pic- 
ture (0 is no limit). 


1. XIN accepts up to N points of input from the terminal. ‘The 
resulting graphic vector is a set of 2-dimensional objects. The 
value of the controls are determined by the index of the char- 
acters (zero origin) in CH; resulting controls are: 


CONTROLS+ 1+CH1INPUTACHAR 


2. Blank terminates input prematurely. 
Carriage return, break, or other ASCII control characters give 
unpredictable results. 


Creates a graphic vector with a maximum of 20 points. Accept- 
able input characters are N, O, L and C. The value of a 
control generated by an input character is determined by its 
origin 0 index in CH. Thus, the controls produced by 
N, P, L andC are 0, 1, 2 and 3 respectively. 
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(d) 11 


FUNCTION: 


SYNTAX: 


DESCRIPTION: 


NOTES: 


EXAMPLES: 


A<FOLLOW 


FOLLOW 

GV+FOLLOW 

“Draw as you go” form of XIN. 

Input control characters on the Tektronix keyboard are: 


Numerics used directly as controls, i.e.: 

0,2,4,6,8 Move to crosshairs 

1,3,5,7,9 = Draw to crosshairs (from previous 
point). 

N Begin new object (i.e. control is 1p0D) 

P Draw to nearest point 

L Draw to nearest line 

C Circular arc through previous, current and next 

points. 


All other characters are ignored. 


b 


Crosshairs appear on the screen. Move the crosshairs and key 
in control characters as necessary to register points. 
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(d) iii Graphics tablet 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


RIGHT PARAMETER N: 


TABLET 
GV+TABLET N 
Pen input on the Tektronix 4953. 


If N=0: Point to point input (connect the dots); each push of 
the pen inputs one point. Removing the pen from the 
tablet terminates input. The result is a single object, 
containing as many points as there are pen pushes. 


If N=1: Continuous input (curve or feature tracing). Points 
are input at several points per second for as long as 
the pen is pushed. Each pen push produces an object 
delimiter, allowing several features to be entered at 
once. The result contains as many objects as there are 
pen pushes. 
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OUTPUT FUNCTIONS 


(a) 


Graphic Output 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


RIGHT PARAMETER GV: 


Drawing from Files 
SYNTAX: 


RIGHT PARAMETER F: 


NOTES: 


DRAW 
DRAW GV 
Draws graphic objects. 


If the graphic vector to be drawn is an Nx3 matrix, it is clipped 
to the screen boundaries and drawn. 


DRAW F 


If F is a vector, read and draw components 1+F from the file 
tied to 1+F’. 


If F is a scalar or a one-element vector, read and draw all 
components of the file tied to F (character components and 
packages are ignored). | 


DRAW applies the global transform TRANS. This maps the 
user’s coordinate space to an origin centered, unit-radius space; 
clips the picture to the screen boundary as defined by 
SMTRANS; and applies the transform SMTRANS to obtain 
screen coordinates. It then calls the function OUTTERM to con- 


vert the controls and coordinates into terminal-dependent for- 
mat, and [ ]ARBOUT' this to the terminal. 
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(b) Text Output. The major output functions for character text output are DRAWSTR and TEXT. Text is 
defined as a vector of character strings delimited by their first element. The first character after each definition 
is the type font to use. The shape of the text vector is the number of strings in it. See APPENDIX A 
(GLOSSARY) - page 120 - for a precise definition of text. 


VR<SHAPE S 
[1] R++/STRINGe1tSTRING 
V 


EXAMPLES: 


SHAPE '/OFIRST/8SECOND/2THIRD' 


3 

SHAPE * THIS HAS FIVE INVALID STRINGS! 
5 

SHAPE '' 
0 


The set of APL-like functions for graphic vectors also manipulate character-string vectors. 
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FUNCTION: 


SYNTAX: 


LEFT PARAMETER Bx: 


RIGHT PARAMETER SV: 


NOTE: 


EXAMPLES: 


DRAWSTR 
BX DRAWSTR SV 


Zero or more boxes to set the boundaries for the text to be 
drawn. For example, BX may be a rectangle with the bottom 
left-hand corner at screen coordinates (0,0) and the top right- 
hand corner at the point (1,5). BX would be defined as follows: 
BXe0-0 15 


Text string vector. Strings are delimited by the first character 
in the first string. The first character after each string delimiter 
in SV is the type font. 


On all terminals, font O is APL hardware characters and fonts 
8 and 9 are stroke characters (drawn representations of the 
standard character set). 

On the TEX4015 type fonts O, 1, 2 and 3 are APL; 4, 5, 6 and 
7 are ASCII; 

(4 |type) controls character size. 


Each string in SV is drawn such that the first character in the 
string is located at the upper left-hand corner of the box. Stroke 


"characters are scaled to fit the box. 


The following condition must hold: 
(1tpBX)=SHAPE SV 


(3 4p0 O 5 1) DRAWSTR '/0ONE/8TWO/2THREE' 


ONDEE 
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FUNCTION: TEXT 


SYNTAX: BX TEXT SV 
DESCRIPTION: Similar to DRAWSTR but does not support stroke characters. 
EXAMPLES: 


(3 400 O 5 1) TEXT '/0ONE/8TWO/ 2THREE' 


ONBEE 
FUNCTION: VTEXT 
SYNTAX: GV<VTEXT SV 
DESCRIPTION: Inserts linefeeds and backspaces for vertical text. 


EXAMPLES: 


(1 4p0 O 1 5) DRAWSTR VTEXT '/8VERTICAL TEXT" 


KIH POH 
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FUNCTION: 
SYNTAX: 
DESCRIPTION: 


RIGHT PARAMETER SV: 


EXAMPLES: 


A<'/8EENY MEANY/8MINEY MOE! 
SHAPE A 


A<STR A 
SHAPE A 


DRAW A INBOX 0051 


FUNCTION: 
SYNTAX: 
DESCRIPTION: 


RIGHT PARAMETER STI: 


EXAMPLES: 


A<'/8EENY MEANY /8MINEY MOE! 
SHAPE A 


A<STR5 A 
SHAPE A 


STR 
GV<STR SV 
Produces stroke (drawn) characters. 


Text string vector. One object is created for each character in 
SV (excluding delimiters and type fonts). 





STR5 


GUESTĄS.SV 
Produces stroke (drawn) characters. 


Text string vector. One object is created for each substring in 


SV. 


(2 490 0 51 5 1 8 2) DRAWSTR A 


HINEY MOE 
LENY MEANY 
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(e) 


Boxes and Clipping. Boxes may be used for placement of text or for moving pictures about in a manner akin 
to “viewport/window” techniques. | 


A box is an Nx4 matrix representing a collection of N rectangles. In standard format, each row of the matrix 
represents the lower left cartesian (X,Y) coordinate and the upper right cartesian (X,Y) coordinate of the 
rectangle. Interesting effects can be produced by interchanging box coordinates. 


FUNCTION: BOX 

SYNTAX: GV+BOX BX 

DESCRIPTION: Produces a drawable graphic vector of the boxes specified by 
BX. 

RIGHT PARAMETER Bx: BX defines the lower left and upper right corners of the boxes. 

EXAMPLES: 


DRAW BOX 002 1 


DRAW BOX 2 152 


| 
| 


BOX 2 1 5 2 


BOX 0021 
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FUNCTION: 


SYNTAX: 


DESCRIPTION: 


LEFT PARAMETER GV: 


RIGHT PARAMETER 5X: 


NOTE: 


EXAMPLES: 


DRAW A+3 POLY 14 


DRAW BOX 00 2 1 


| | 


INBOX 


GVR<GV INBOX BX 
Places GV inside the boxes BX. 
A graphic vector. 


An Nx4 matrix of boxes. Each row is a box. 


(SHAPE GVR)=(SHAPE GV)[1tpBX 
The shorter argument is extended using RESHAPE. The I’th 
object in GV is placed in the I’th box. 





DRAW A INBOX 00 2 1 
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Swapping box coordinates allows mirror images and reflections: 


he Bie Boh OSG 7658 rufe 1541641311 


Above boxes are: normal, swap X, swap Y, swap X and Y 


TXT<' /OFIRST/OSECOND/OTHIRD/OFOURTH ' 
DRAW (STR 5 TXT) INBOX A 
DRAW BOX A 
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FUNCTION: CLIP 


SYNTAX: ‚GVR+-BX CLIP GV 


DESCRIPTION: Rectangular clipping - GV is clipped to the box BX. 
LEFT PARAMETER Bx: A box that defines the clipping boundary. 

RIGHT PARAMETER GV: Vector of objects to be clipped by BX. 
EXAMPLES: 


DRAW 3 POLY ı5 


DRAW BOX 1254 





DRAW 1 2 5 4 CLIP 3 POLY 15 
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FUNCTION: 
SYNTAX: 


DESCRIPTION: 


RIGHT PARAMETER CY: 


RESULT 3X: 


NOTE: 
EXAMPLES: 


DRAW A+5 DAISY 13 


IMM 

BX+IMM GV | 

Itemwise minimum/maximum of the graphic objects in GV. 
Graphic vector. 

The result is boxes that fit exactly around the objects GV - i.e. 
the bottom left corner coordinates are calculated for the mini- 


mum X,Y, the top right-hand corner for the maximum X,Y of 
the objects in GV. 


(1tpBX)=SHAPE GV 





64 


DRAW BOX IMM A 


DRAW BOX IMM MOS A 
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(d) Grid functions - GRID and MENU. 


FUNCTION: GRID 

SYNTAX: GV+GRID N 

DESCRIPTION: Generates a line grid. 

RIGHT PARAMETER W: N[1 2] = grid size in elements, X by Y 


N[3 4] = interelement spacing (X,Y) 
(default 1,1) 

N[5 6] = lower left corner of the grid, 
(default O 0). 


EXAMPLES: 


DRAW GRID 7 4 
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DRAW GRID 7 9 .5 


FUNCTION: 
SYNTAX: 


DESCRIPTION: 


LEFT PARAMETER: 


RIGHT PARAMETER: 


RESULT R: 


NOTES: 


1. 


5 





MENU 
ReN MENU CH 


Select from a menu with crosshairs. This function is supported 
on the Tektronix 4013/4015 and the HP 2648A. 


N is the maximum number of selections allowed. Zero implies 
no limit. 


CH is a character matrix of menu items. 


Is a vector of origin 1 row indices into the character matrix of 
the items selected. Each index is produced by user-selection 
from the menu. 


The menu is drawn and the crosshairs appear. The user selects 
from the menu by placing the crosshairs inside the rectangle 
containing the name of the desired item, and striking any 
graphic key. A star will be drawn in the box indicating that a 
selection was made. A space will terminate the menu prema- 
turely. 


67 





BOO 
DOO 
FOO 
GOO 
MOO 
POO 
SOO 
U00 
ZOO 


9 


2 


EXAMPLES: 


DIR+9 3p'BOODOOFOOGOOMOOPOOSOOU00ZOO' 


DIR 


CHOICES<0 MENU DIR 


CHOICES 
y 


Here ZOO, GOO, DOO were selected (in that order). 
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(e) Screen Control 


FUNCTION: COMIX 
SYNTAX: | TRF+COMIX N 
DESCRIPTION: Produces comic strip transforms. The result is normally as- 


signed to the global variable CTRANS which is used to divide 
the terminal screen into several subscreens. 


RIGHT PARAMETER J: COMIX will produce N*2 transforms. 
NOTE: COMIX ıs a transform function, and is listed as such in AP- 
PENDIX B. 


VFOO N;I;CTRANS 
[1] CTRANS<COMIX N 
[2] N=<NxN © I<1 © ERASE 
[3] LO: DRAW (u+I) DAISY 19 © NEXTFR 
[4] +(N2I+I+1)pL0 


FOO 3 


PIII BA 
ue N REASON >) 
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[1] 
[2] 
[3] 
[4] 
[5] 


FUNCTION: 

SYNTAX: 

DESCRIPTION: 

RIGHT PARAMETER W: 

EXAMPLES: 

VFOO N;I;J 
CTRANS+COMIX N 


N+NxN © J+N?N O I+1 
LO: FRAME JLI] 


DRAW (4+I) DAISY 14 | 


>(N2I+I+1)pLO 


FOO: 3 





FRAME 


FRAME N 


Causes frame (1tpCTRANS) |N to be used for the next draw. 


The frame number to use for the next draw. 





FUNCTION: 
SYNTAX: 


DESCRIPTION: 


EXAMPLES: 


VFOO NI 
[1]  CTRANS<COMIX N 
[2]  N<NxW © I<1 © ERASE 
[3] Lo: DRAW (u+I) DAISY 14 
[4]  NEXTFR © >(N2I+I+1)pL0 
y 


BOO: 2 








NEXTFR 
NEXTFR 


Causes the next subscreen to be used for subsequent DRAWs. 
When all subscreens have been used, aWAITCR © ERASE is 
executed. 











LENN 
ANS 
NE : NN 
[LSP 


LAV Lf 
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(£) 


FUNCTION: 
SYNTAX: 


DESCRIPTION: 


NOTES: 


FUNCTION: 
SYNTAX: 


DESCRIPTION: 


FUNCTION: 
SYNTAX: 


DESCRIPTION: 


Square Plots. 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


RIGHT PARAMETER N: 


EXAMPLES: 


DRAW SQPLOT 676 


ERASE 
ERASE 


Clears the screen and homes the cursor on CRT terminals; on 
hard copy terminals a form feed is executed. 


ERASE has no effect on Multiwriter II terminals, as these 
ignore form feed. 

WAITCR 

WAITCR 


Waits for a carriage return. 


WHATFR 
N+WHATFR 


Returns the current frame number. 


SQPLOT 
GV<SQPLOT N 
Creates a graphic vector to draw a square plot. 


N is a numeric vector of data to be plotted. 
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(g) 


The “In between” functions INBT and DRAWINBT. 


FUNCTION: INBT 

SYNTAX: GV3+N INBT GV1,[1]GV2 

DESCRIPTION: Generate a set of N objects between two graphic vectors GV1 
and GV2 by linear interpolation. 

LEFT PARAMETER W: N is the number of objects to be generated. 

FUNCTION: DRAWINBT 

SYNTAX: N DRAWINBT GV 

DESCRIPTION: The same as DRAW N INBT GV but avoids WS FULL by 


drawing as it goes. 
EXAMPLES: 


DRAW A<(4 POLY 1),[1]BOX 5 55 5 
DRAW 10 INBT A 








(h) Decorating with the HATCH group of functions. 


FUNCTION: DASH 
SYNTAX: GVReN DASH GV 
DESCRIPTION: Restructure GV to draw with dashed lines. 
LEFT PARAMETER J: A matrix of dash lengths and interdash spaces. 
RIGHT PARAMETER GV: The graphic vector of objects to be dashed. 
EXAMPLES: 
DRAW .2 .2 DASH 3 POLY 13 A 
/ A 
/ 
IN 
/ / \ \ 
/ / \ 
\ 
/ \ 
/ MN \ 
/ / \ \ 
\ 
/ / / \ \ 
/ \ \ 
/ / / \ \ 
/ o 
z mann \ 
/ / \ x 
/ ae «w w ma wm «w w a að 
| ea en a | 
DRAW .2 .2 .1 .2 DASH MO -4+9?9 
’ 
0 a : 
I» d i 
Y i = ' p 
e . \ é * 
R ' 
A 1 ; Sa 
E E w í ll 
' i ` . ; 
\ N . | \ 
ER E pl A 0 
| N s y e p 
A f N 
Á ® 
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FUNCTION: HATCH 


SYNTAX: GV+N HATCH GV 

DESCRIPTION: Cross-hatch GV. 

LEFT PARAMETER N: | N[ 1 ]=angle of hatch lines 
N[ 2 ]=spacing between hatch lines. 

RIGHT PARAMETER GV: Graphic vector of the object to be hatched. 

NOTE: AATCH will produce unpredictable results if GV is not a closed 
object. 

EXAMPLES: 


DRAW 30 .1 HATCH 4 5 6 POLY 13 


NW | 


ON 
~ 


N 
in 





SECTION II-B 


TRANSFORMS 


Transforms (TRF) are rank-3 arrays that describe the movement and position of objects in space. Each plane 
represents a single linear transform that may be applied to a single object or to all objects in a graphic vector by use 
of the dyadic functions TAT and AT respectively. 


For pictures in two dimensions, a single transform is a 1x3x3 array representing values of rotation, translation and 


scaling, while for three-dimensional objects it is a 1x4x4 array. Transforms may generally be combined by catenation 
along the first coordinate. Most graphic functions treat a transform as a one-element vector or scalar. 
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BASIC TRANSFORMS 


1) Scaling 


FUNCTIONS: SCALE and SAP 
DESCRIPTION: The process of shrinking or magnifying an object. Scaling may 


be considered analogous to “zoom” and may be performed 
about the coordinate origin using SCALE, or a specified point 


using SAP. 
2) Rotation 
FUNCTIONS: ROT and RAP 
DESCRIPTION: The process of rotating an object about a point, either about 
the coordinate origin using ROT, or about a specified point 
using RAP. 
3) Translation 
FUNCTION: XLATE 
DESCRIPTION: The process of moving objects. The function XLATE applied 
to an object will move it in a manner analogous to “reposition ’, 
“tilt” and “pan”. 
NOTE: The function RSAP may be used to simultaneously rotate and 


scale about a point. 


TRANSFORM GENERATORS 


The transform generating functions SCALE, ROT, XLATE and others - see APPENDIX B (page 131) for a 


complete list, generate arrays that will scale, rotate or translate objects when “applied” to them. 


For example, XLATE X where X is a scalar, will produce a transform that will move an object to the left or right 
when applied to the object using one of the functions AT or IAT. Similarly, SCALE S will produce a transform 


that will enlarge or shrink an object when applied. More details follow: 
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FUNCTION: 
SYNTAX: 
DESCRIPTION: 


RIGHT PARAMETER S: 


SCALE 


TRF+SCALE S 


SCALE produces transforms to scale about the origin. 


The shape of S controls scaling as follows: 


(a) 1=x/pS 


Scaling in all coordinates by S when S is a scalar or 
a one-element vector (no distortion). 


(b) S=(R,1) matrix 


Scaling in all coordinates by S when S is a one-column 
matrix. | 


For example: 

3 

2 

1 

is treated as (S, S), 
3 3 

22 

11 

as a convenience. 


(c) S=(R,2) matrix 


Scaling in 2-space (two dimensions) along both the 
X and Y axes when S is a two-column matrix. Each 
row of 5 is a scaling; column 1 is a scaling along the 
X-axis and column 2 along the Y-axis. 


(d) S=(R,N) matrix 
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Scaling in N-space (3 or more dimensions), by S, 
when S is an N-column matrix. Each row of S is a 
scaling. 


N must equal the number of dimensions in which you 
are working. | 





FUNCTION: 
SYNTAX: 


DESCRIPTION: 


RIGHT PARAMETER KU: 





ROT 
TRF+ROT RU 


ROT produces transforms which rotate objects about the ori- 


gin. 


RU specifies the rotation to be applied to the object. Both the 
unit and the direction of rotation are dependent on the variable 
DEGR (see page 118). If the default value of DEGR is used, 
rotation is measured in degrees. A positive rotation (RU>O) is 
counter-clockwise. 


The shape of RU controls rotation as follows: 


(a) 1=x/pRU 
One transform is created when AU is a scalar or a 


one-element vector. The transform specifies a rotation 
of AU units. 


(b) RU=(N,1) matrix 
When RU is an (N,1) matrix, N transforms are 
created. That is, V=1+pTRF. The J’th transform 
TRF[ I; ; ] specifies a rotation of R[Z; | units. 


(c) RU=(N,2) matrix 

A 3-D transform is created for each row of AU. The 
first column specifies the coordinate the rotation is to 
be applied to; the second column is the rotation to be 
applied. For example, if RU[I; ]+2 30, the rotation 
applied will be 30 units about the second coordinate 
(the Y-axis). Note that RU[I;1] must be either 
Ty 23,073: 


(d) RU=(N,3) matrix 
A 3-D transform is created for each row of RU. The 
columns specify the rotation to be applied to the first, 
second and third coordinates respectively. 
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FUNCTION: 


SYNTAX: 


DESCRIPTION: 


RIGHT PARAMETER X: 


XLATE 


TRF+XLATE X 


XLATE generates translation transforms. 


The sha 


pe of X controls the translation as follows: 


(a) 1=x/pX 


Translation along the first coordinate (X-axis), by. 
X units, when X is a scalar or a one-element vector. 


(b) X=(R,1) matrix 


(c) X=( 


(d) X= 
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Translation along the first coordinate by X units 
when X is a one-column matrix which is treated as 
(X,0) as a convenience. 

For example: 

3 

2 

1 

is treated as 

3 0 

20 

1 0 


, 


R,2) matrix 

Translation in 2-space (two dimensions) along both 
the X and Y-axes. Each row of X is a translation; 
column 1 is translation along the X-axis, column 2 
along Y. 


(R,N) matrix 
Translation in N-space along all coordinates when X 
is an N-column matrix. 


N must equal the dimensions you are working in: 
2-dimensions --> N=2 

3-dimensions --> N=3 

etc. 








TRANSFORM APPLICATORS 


Once the transforms have been generated, we need functions to apply them to graphic vectors. These functions are 


AT and IAT. 
FUNCTION: 
SYNTAX: 
DESCRIPTION: 


LEFT PARAMETER GV: 


RIGHT PARAMETER TRF: 


NOTE: 


FUNCTION: 


SYNTAX: 


DESCRIPTION: 


PARAMETERS: 


NOTE: 


AT 
GVReGV AT TRF 


Outerproductly apply transform. Every transform in TAF is 
applied to every object in GV. 


The graphic vector to be transformed. 


The transforms that will be applied to GV to produce the 
transformed graphic vector GVA. 


(SHAPE GVR) = (SHAPE GV)x1*+pTRF. 


IAT 

GVR<GV IAT TRE 

Itemwise apply transform. Each transform in TRF is applied 
to the corresponding object in GV. The shorter argument is 
reused as in RESHAPE. 


The parameters for JAT are the same as those for AT. 


(SHAPE GVR) = (SHAPE GZ)DASOTRE. 
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COMBINING TRANSFORMS 
Transforms may be combined when two or more have to be applied to the same graphic vector. The first transform 
may be transformed by the second giving a combined transform to be applied to the graphic vector. This helps to 
prevent W5 FULL and tends to be more CPU-efficient than applying each transform separately. 
For example: 


(SCALE 2) TE XLATE 5-4 


will produce a transform that will both scale and translate an objecı. 
The dyadic functions TT and ITT combine two transforms. The result is a new transform. 


FUNCTION: TT 
SYNTAX: IRERETREA TT TREB 
DESCRIPTION: Outerproductly combine transforms. Every transform on the 


right is applied to every transform on the left, that is: 
(1tpTRFR) = (1tpTRFA)x1tpTRFB 


FUNCTION: | ITT 
SYNTAX: TRFR=<TRFA ITT TRFB 
DESCRIPTION: Itemwise combine transforms. Each transform on the right is 


applied to the corresponding transform on the left. The shorter 
argument is reused, as in RESHAPE’. 
(1tpTRFR) = (1tpTRFA)[1tpoTRFB 
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One rather important point which, once understood, avoids utter dark mystery: 


When transforms are combined, they act as if they had been applied separately in the order from left to right. Since 
transform combining is basically a +. x process, it is not commutative. 


The order in which transforms must be combined, is therefore SCALE->ROTATE->TRANSLATE. 


To see why the order in which transforms are combined is important, try these examples: 


DRAW ((3 POLY 1) AS 2) AX 3 1 a RIGHT: SCALE, THEN TRANSLATE. 


bre 


DRAG 3 POLY 1 
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OT 


DRAW (3 POLY 1) IAT (SCALE 2) TT XLATE 3 1 a ALSO RIGHT. 


BRA ( E 2) TT MATE 3 1 


DRAI 3 POLY 1 








versus 


DRAW ((3 POLY 1) AX 3 1) AS 2 A WRONG: TRANSLATE, THEN SCALE. 


DRAM (13 POLY 1) AX 3 


DRA 3 POLY 1 
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or 


DRAW (3 POLY 1) IAT (XLATE 3 1) TT SCALE 2 a ALSO WRONG. 


DRAI (3 POLY 1) IAT ( 


DRAW 3 POLY 1 


Scaling about the origin after translation causes the picture to move toward or away from the origin by the scaling 
factor. 


Rotation after translation can be used to create special effects as in the scalloped border in the label (TM) below. 
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SPECIAL CASES 


The following are special transform functions for cases not covered efficiently by combining the three basic trans- 


forms: 


FUNCTION 


SAP 


RAP 


RSAP 


ID 


COMIX 


SYNTAX 


TRE+XY SAP SCL 


TRF+XY RAP RU 


TRP+(SCL,XY) ASAP RU 


Tare N 


TRE<COMIX N 


DESCRIPTION 


Scaling transform about point XY by scaling factor SCL. Equiva- 
lent to 
TRF<(XLATE -XY) ITT (SCALE SCL) ITT XLATE XY 


Rotation transform about point XY for RU rotational units (usual- 


ly degrees). 
Scaling and rotation transform about point XY for RU units. 


Identity transform for N-space. Application of an identity trans- 
form to a graphic vector or transform, leaves the graphic vector or 
transform unchanged. 


Builds comic strip transforms. For example, to set the global varı- 
able CTRANS to the number of subscreens: 

CTRANS<COMIX N divides the screen into /N/x2 subscreens. 
Each subscreen can be used independently, as if it were the whole 
screen using the functions. | | 

(See Screen control in SECTION II-A, Input-Output Functions 
for examples. ) 
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SUMMARY OF TRANSFORM FUNCTIONS 


Scaling Rotation 
SCALE S ROT RU 
AS S AR RU 

IAS S IAR RU 
SID ITR RU 
SAP S RAP RU 


1) Transform Applicators 


AX GV<GV AX XL 
AS GV+GV AS SCL 
AR GV+GV AR RU 
IAX GV+GV IAX XL 
IAS GV<GV IAS SCL 
IAR GV<GV IAR RU 


2) Transform Combinations 


TX TRE+TRF TX XL 





TS 


TR LRP CLAP TR AU 
ITX TRF+TRF ITX XL 
ITS LRESTRE IES OC 


ITR 


„NEST TS 00, 


LRESTRF ITR- RU 


Translation Special 

XLATE X (SCL,XY) RSAP RU 
AXX COMIX N 

TAX X IDN 

TTX A 


Eb ad 


I 


SHORT FORMS 


GV<GV AT XLATE XL 
GV+GV AT SCALE SCL 
GV<GV AT ROT RU 
GV<GV IAT XLATE XL 
GV+GV IAT SCALE SCL 
GV+GV IAT ROT RU 


TRE<TRF TT XLATE XL 
TRE<TRE TT SCALE SCL 
LREFTAP FI" ROL RU 
TRF+-TRF ITT XLATE XL 
LRP SLAP ATT SCALE SCL 
LAPELRE ITT ROT RU 
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SECTION II-C 


APL-LIKE FUNCTIONS 


(a) Shape - the functions SHAPE, ISHAPE and RESHAPE. 


FUNCTION: | SHAPE 


SYNTAX: N+SHAPE GV 

DESCRIPTION: Number of objects in GV. (“oGV” for objects.) 
RIGHT PARAMETER GV: A graphic vector. 

EXAMPLES: 


SHAPE 3 4 5 POLY 13 


3 
SHAPE 3 4 5 POLY 17 
7 
FUNCTION: ISHAPE 
SYNTAX: | N*«ISHAPE GV 
DESCRIPTION: Number of points in each object in GV. (“oGV” for points. ) 
RIGHT PARAMETER GV: A graphic vector. 
EXAMPLES: 
ISHAPE 3 4 5 POLY 13 
4 5 6 


ISHAPE 3 4 5 POLY ı7 
4564 5 6 4 
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FUNCTION: 


SYNTAX: 


DESCRIPTION: 


LEFT PARAMETER W: 


RIGHT PARAMETER GV: 


EXAMPLES: 


SHAPE 3 4 5 POLY 13 


RESHAPE 

GVR+N RESHAPE GV 

Reshape as in dyadic rho. ( “NpGV” ) 

The number of objects to be produced from GV. 


A graphic vector. 


SHAPE 7 RESHAPE 3 4 5 POLY 13 
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(b) 


Defining Objects - the functions BEGN and DESC. 


FUNCTION: BEGN 

SYNTAX: N+BEGN GV 

DESCRIPTION: Origin 1 indices of object delimiters on GV. 
RIGHT PARAMETER GV: A graphic vector. 

EXAMPLES: 


BEGN 3 4 5 POLY 13 


1.9: 20 
FUNCTION: DESC 
SYNTAX: N+DESC GV 
DESCRIPTION: Descriptions of objects. 
RIGHT PARAMETER GV: A graphic vector. 
NOTE: N=(BEGN GV),[1.5]ISHAPE GV 
EXAMPLES: 


DESC 314 5 POLY 13 
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Index 


FUNCTION: 


SYNTAX: 


DESCRIPTION: 


LEFT PARAMETER GY: 


RIGHT PARAMETER N: 


NOTES: 


EXAMPLES: 


NDX 

GVR<GV NDX N 

Return objects N from GV. (“GVLN]” ) 

A graphic vector. 

Origin 1 indices of the objects to pick from GV. 


O<([ /N)<SHAPE GV 


DRAW (3 4 5 POLY 13) NDX 1 3 


DRAW (3 4 5 POLY 13) NDX 2 
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FUNCTION: 

SYNTAX: 
DESCRIPTION: 

LEFT PARAMETER: 
RIGHT PARAMETER J: 


RESULT GVR: 


NOTE: 


EXAMPLES: 


A<3 POLY 13 
A+(A,L1]US),NDXAS 2 
DRAW A 


NDXAS 

GVR<(GV1,[1]GV2) NDXAS N 

Index assign. (“GVR*GV1 © GVR[N]<GV2") 
GV1 and GV2 are graphic vectors. 


Origin 1 indices of objects in GV1 to be replaced by GV2. 


GVR is GV1 with objects WLI] replaced by 


GV2[I],O<I<pN. 


(pN)=SHAPE GV2 
(SHAPE GVR)=SHAPE GV1 
O<N<SHAPE GV1 


AUS IS A UNIT SQUARE 
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FUNCTION: NDXG 


SYNTAX: R+NDXG N 
DESCRIPTION: Index generator. (“ıN” ) 
RIGHT PARAMETER J: A two column matrix. The first column is starting indices and the second 


is the number of indices to be generated. 
EXAMPLES: 


NDXG 2 2920 5 13 3 
20: 21 22 23 24-13 14 15 


NDXG 20,[1.5] 14 
20 20 21 20 21 22 20 21 22 23 


(d)i Extended compression 


FUNCTION: OF 
SYNTAX: R<M OF N 
DESCRIPTION: M repetitions of N. (“M/N” - sort of ) 
NOTES: (pM)=1tpN 
(1tpR)=+/M 
EXAMPLES: 
09 98028 12 3 
22.2.2 253 dz 3 BS? 9 


($13) OF "ABC"! 
AAABBC 


21.082 pii 


WRP 
FNN 
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(d)ii Compression 
FUNCTION: 
SYNTAX: 
DESCRIPTION: 


LEFT PARAMETER 5: 


RIGHT PARAMETER GV: 


NOTES: 


EXAMPLES: 


4-3 4 5 6 POLY 14 
DRAW 1 0 1 O COMP A 


COMP 

GVR+B COMP GV 

Compression for graphic vectors. (“B/GV” ) 
Boolean vector. | 


Graphic vector to be compressed according to the Boolean vector in the 
left parameter. “ss 


(pB)=SHAPE GV 
(+/B)=SHAPE GVR 





(e) Make Object Scalar 
FUNCTION: 
SYNTAX: 
DESCRIPTION: 
RIGHT PARAMETER GV: 
EXAMPLES: 


SHAPE 4 5 6 POLY 13 


SHAPE MOS 4 5 6 POLY 13 


Partitioned Make Object Scalar 
FUNCTION: 
SYNTAX: 
DESCRIPTION: 


LEFT PARAMETER 5: 


NOTES: 
EXAMPLES. 
A+-3 4 5 6 POLY 14 
SHAPE A 
4 
SHAPE 1 0 1 O PMOS A 
2 


MOS 
GVR<MOS GV 
Removes object delimiters from GV - i.e. graphics ravel. 


Graphic vector to be ravelled. 


PMOS 
GVR<B PMOS GV 
Controlled ravel for graphic vectors. 


Boolean partition vector. 


(oB)=SHAPE GV 
(+/B)=SHAPE GVR 
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(f) Take and Drop 
FUNCTIONS: 


SYNTAX: 


NOTES: 
EXAMPLES: 
A+3 4 5 6 POLY ık 


DRAW A 


DRAW 2 TAKE A 


DRAW 2 DROP A 


TAKE and DROP 


GVR<N TAKE GV 
GVR<N DROP GV 


TAKE will not overtake. 


& 
© 
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(g) 


(h) 


DRAW 2 TAKE A 


DRAW 2 DROP A 


Remove Empty Objects 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


RIGHT PARAMETER GV: 


Remove Multiple Moves 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


RIGHT PARAMETER GV: 


REO 
GVR<REO GV 
Remove empty objects (objects with no points) from GV. 


A graphic vector. 


RMM 
GVR<RMM GV 


Multiple moves are removed from GV; several consecutive moves are 
made one move. 


A graphic vector. 
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This group contains functions: 


SECTION II-D 


UTILITY FUNCTIONS 


ARCTAN, OF, LGRAV, PERPD, PGRAV, MINA, AREA, PMAXSCAN, PPLUSCAN, VTOM, MTOV and 
PTGRD. 


(a) 


Point Grids 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


RIGHT PARAMETER: 


EXAMPLES: 


DRAW (5 5 DAISY 


.1) 


PTGRD 
R<PTGRD N 


Generates translation coordinates for point grids, suitable for AX or 
TAX. | 


N[1 2]= grid size in elements X by Y 

N[3 4J= interelement spacing. X,Y 
(if omitted, 1 1 is assumed) 

N[5 6]= lower left corner of the grid 
(if omitted, 0 O is assumed). 


TAX PTGRD6 811 3 4 
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(b) 


(c) 


(d) 


(e) 


Arctan 


FUNCTION: 


SYNTAX: 


DESCRIPTION: 


RIGHT PARAMETER XY: 


Area 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


EXAMPLES: 


AREA 4 POLY 2x.5 


Arcs 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


Line Gravity 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


ARCTAN 
R+ARCTAN XY 
Returns the arctan of the angle between point XY and the X axis. 


A two-column matrix of cartesian coordinates (X,Y). 


AREA 
R+AREA GV 


The area enclosed by GV. Positive if traced clockwise; negative if traced 
counterclockwise. GV should be a closed object. 


CIRCLE 
GV+CIRCLE XY 


Defines circular arc through the three points given in XY. 
3 2 = pXY. 


LGRAV 
GVR<XY LGRAV GV 


Drops a perpendicular line from a point XY to the nearest point on 


GV. 
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(f) Minimum Distance 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


(g) Perpendiculars 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


(h) Point Gravity 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


(i) Partitioned Max Scan 
FUNCTION: 
SYNTAX: 
LEFT PARAMETER: 
RIGHT PARAMETER: 


EXAMPLES: 


2 


[\8 795 3 4 12 
8 8999912 


MINA 
N1<XY MINA N 


Returns the point from list V (calculated by PERPD) that is closest to 
XY. | 


PERPD 


: N<XY PERPD GV 


Drops perpendicular lines from a point XY to all lines in an object. 


PGRAV 
N1+XY PGRAV GV 


Returns the point on GV closest to XY. 


PMAXSCAN 
R+B PMAXSCAN N 
B is a Boolean partition vector. 


N is a numeric vector. 


10021000 PMAXSCAN 8795 3 4 12 
oe 
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0) 


1 2 


1 2 


(k) 


/A 
/BCD 
/EF 
/G 
/H 


Partitioned Plus Scan 


FUNCTION: 


SYNTAX: 


LEFT PARAMETER: 


RIGHT PARAMETER: 


EXAMPLES: 
1-0 0:10 970.272 3CAN Tol 

314234 

+\7p1 
34567 

Vector To Matrix 

FUNCTION: VTOM 

SYNTAX: M<VTOM CH 

DESCRIPTION: VTOM produces a character matrix from CH. 
RIGHT PARAMETER: CH is a character vector. 

14CH delimits substrings within CH. 
EXAMPLES: 
VTOM '/A/BCD/EF/G/H' 


PPLUSCAN 
R<B PPLUSCAN N 
Boolean partition vector. 


N ıs a numeric vector. 
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(1) Matrix To Vector 


FUNCTION: MTOV 
SYNTAX: V<CH MTOV M 
LEFT PARAMETER CZ. Trailing CH are removed. 


RIGHT PARAMETER: Matrix to be converted to a character string. The first column of the 
matrıx M should be delimiters. | 


EXAMPLES: 
M<VTOM '/A/BCD/EF/G/H' 


UP TOV 
/A/BCD/EF/G/H 
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SECTION II-E 
THREE-SPACE FUNCTIONS 
When working in three dimensions, the 3-dimensional object created has to be converted to a two-dimensional 
projection of itself before it can be drawn. The viewpoint is the screen origin (0,0,0) and viewing is done outward 
along the positive Z-axis. The picture plane is perpendicular to the Z-axis. The distance between the viewer and 


the picture plane determines the size of the picture. Objects closer than the picture plane will be badly distorted. 


Wire-frame drawing with back plane removal is supported at present. Hidden line algorithms do exist for these 
workspaces, but are very expensive. Single point (camera) perspective is used. The user must do the 3-D clipping. 


The functions in this group are: 


TO2D, VIEW, POLY3, and SOLID and CUBE. 


Execute the function THREED to define these functions in the workspace. 


(a) View 

FUNCTION: VIEW 

SYNTAX: GV<N VIEW GV3D 

LEFT PARAMETER: N[ 1] is the distance of the picture plane from the viewer. It 
is effectively a scalar magnification applied to the result. 
N[2] is a translation to be applied to the 3-D objects GV3D 
along the Z-axis, before viewing them. 

RIGHT PARAMETER: Must a be three-dimensional graphics vector, (i.e. there must 
be 4 columns in the matrix GV3D). 

RESULT GV : The two-dimensional view of the three-dimensional objects in 
GV 3D with back plane removal. 

NOTE: The statement DVIEW GV3D is equivalent to 


DRAW VPT VIEW GV3D. 
VPT has the default value of 50 120. 
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(b) 


(c) 


To Two-Dimensional View. 


FUNCTION: 
SYNTAX: 
DESCRIPTION: 
PARAMETERS: 


NOTE: 


Cylinders 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


LEFT PARAMETER: 
RIGHT PARAMETER: 
NOTE: 


EXAMPLES: 


TO2D 

GV2D<N TO2D GV3D 

TO2D is similar to VIEW without back plane removal. 

The parameters are the same as for VIEW. 

The statement DTO2D GV3D is equivalent to 


DRAW VPT TO2D GV3D. 
VPT has the default value of 50 120. 


POLY3 
GVeN1 POLY3 N2 


Produces the end-planes of a three-dimensional N-gon cylin- 
der. | 


N1 is the number of sides. 
N2 is the radius of each polygon in V1. 


The length of the cylinders is twice the radius. 


DRAW 50 120 TO2D (4 POLY3 1) AT ROT 1 3p30 45 O 











DRAW 50 120 VIEW (7 POLY3 1) AT ROT 1 3p30 450 
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(d) 


Wire Frame Drawings 
FUNCTION: 
SYNTAX: 


DESCRIPTION: 


RIGHT PARAMETER GV: 


EXAMPLES: 


SOLID 
GVReSOLID GV 


Produces a wire frame drawing of a cylinder from the end 
planes supplied by POLY3. 


Graphics vector containing the end planes of a cylinder. 


DRAW 50 120 TO2D SOLID (4 POLY3 1) AT ROT 1 3p30 45 0 
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DRAW 50 120 VIEW SOLID (7 POLY3 1) AT ROT 1 3p30 45 0 
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(e) 


Cubes 


FUNCTION: CUBE 

SYNTAX: GV3D<CUBE N 

DESCRIPTION: Produces an exact cube with sides of leigh N. 
RIGHT PARAMETER N: Radius of cube GV3D. 

EXAMPLES: | 


DRAW 50 120 TO2D SOLID (CUBE 1) IAR 1 3p30 45 


.1x110) IAR 1 83830 


DRAW 50 120 VIEW SOLID (CUBE 
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SECTION II-F 


FILE FUNCTIONS 


The following functions simplify the storage and retrieval of objects on file. 


FUNCTION 


FIND 


GET 


QT 


OCRE3 
FSHAPE 
FISHAPE 


FBLOCK 


FIAT 
FAT 
DRAW 


TABTOFILE 


SYNTAX 


F+LIB FIND NAME 


GV+GET NAME 


N<QT FNAME 


N<QCRE8 FNAME 
N<FSHAPE F 
N<FISHAPE F 


N<FBLOCK F 


PEP FIAT PRE 
FEF" FAT TRF 
DRAW F 


F<N TABTOFILE FNAME 


COMMENTS 

Look up NAME in the directories of the files LTB (one file name 
per row). F is the file tie number, component numbers that the 
objects in NAME occupy. 

Look up and read the first component of NAME from the file 
library. The global variable LIB contains the id's of files to be 
searched for NAME. 


The result is the tie number of FNAME’ If the file is not tied, | 
QL. OTIR St 


Similar to QT but creates FNAME if it does not exist. 

File shape. i.e. the number of objects. 

File itemwise shape. i.e. the lengths of objects. 

Data is reblocked to approximately N points per component. 
Each component is a minimum integral number of objects, such 
that (1tpCOMPONENT) > M. l 

File itemwise apply transform. 

File outerproductly apply transform. 


Draw - see Input/Output functions. 


Graphic tablet to file. V is the same as in the graphic tablet 
function TABLET. | | 
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APPENDIX A 


GLOSSARY 

Abbreviations 

GV a graphic vector i.e. zero or more objects 

TRF zero or more transforms 

XL translation amounts 

SCL scaling amounts 

RU rotational units 

N numeric data 

CH character data 

SV text string vector (substrings delimited by 14+5V) 

ZY cartesian data 

B Boolean partition vector, (ones start each partition); or Boolean compression /expansion vector 

p file tie number, component-number vector 

FNAME file name 

BX zero or more boxes. 
Boxes 


Boxes may be used for placement of text, or for moving pictures about in a manner akin to “viewport/window” 
techniques. 


A box is an Nx4 matrix representing a collection of N rectangles. In standard format, each row of the matrix 
represents the cartesian (X,Y) coordinates of the lower left and the upper right corners of the box. 
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Global Varıables 


TRANS 


CTRANS 


SMTRANS 


SV 
OD 


PD 


DEGR 


TRANS is a transform which maps the arbitrary 2-space of the user into a 
unit-radius origin centered space. This allows the user to change the portion of 
the universe displayed on the screen. The default setting is 
TRANS<SCALE:10 i.e. radius 10, origin centered. 


CTRANS is an array of transforms which may be used to divide the screen into 
subscreens. Each plane of CTRANS represents one subscreen. All subscreens have 
the same aspect ratio as the whole screen. The NEXTFR function causes DRAW 
to use the next subscreen. When the last frame is used, a WAITCR © ERASE 
is executed. FRAME N causes the DRAW function to use FRAME N, and 


WHATFR returns the current frame number. 


SMTRANS is a terminal dependent transform that maps the unit radius origin 
centered clipping space into the physical terminal screen space. Most users will 
never need to modify SMTRANS. This transform is defined by the TERM function. 


SV is the state variable and contains assorted data used by the graphics system. 
Selected elements are documented in the file SVDOC. 


OD is a vector of controls defining a set of object delimiters. Its default is 
4 2. 


PD is the polygon delimiter, and is used by certain three-dimensional space 
functions. Its default is 8 6. 


A multiplicative conversion factor from the user’s measure of rotation (usually 
degrees) to radians which are used by the APL circle functions. This allows the 
user to specify rotation in the most convenient units for a particular application. 
The conversion is performed automatically by the graphics functions. 

If DEGR is positive, then positive rotations are clockwise and negative rotations 
counterclockwise. If DEGR is negative, the opposite is true. 

The default value of DEGR is (01)+180, the conversion between degrees and 
radians. If you plan to use rotational units other than degrees, DEGR should be 
set accordingly. 
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Objects, Graphic Vectors and Controls 


A collection of points and/or line segments in space is called an object. It is represented as a set of controls (pen 
up; pen down; draw a point; new object) and cartesian coordinates defining a line drawing (X,Y when working in 
a single plane i.e. in two dimensions or 2-space; X,Y,Z when working in three dimensions or 3-space). The first 
control on an object must be an object delimiter. 


An object is represented as a numeric matrix (GV). Each row of the matrix represents a point of the object; the 
columns are assigned as follows: 

(N,3) = pGV --> 2-space 

(V,4) = pGV --> 3-space 

(N,M) = oGV --> (M-1 )-space 


_GVL;1] = Controls (Beginning of object, move, draw, make point, pen type) 
GVL;2] = First coordinate (X) 
GV[;3] = Second coordinate (Y) 
GVL 3M] = (M-1)th coordinate (Z....) 


An object is treated as an entity by the graphics system in much the same manner as a scalar is treated by APL. 
An object may be thought of as a graphic scalar and most graphic functions treat an object as a scalar or a one-element 
vector. Zero or more objects, catenated along the first coordinate, form a picture or graphic vector. Most graphic 
functions treat an N-object picture as an N-element vector. 


Controls 
Individual objects within a graphic vector are delimited by a control called the object delimiter. An object delimiter 


( 4 is the default value) indicates the beginning of an object. The global variable OD defines a set of controls that 
are object delimiters. Recognized controls include: 


~4=CONTROL --> Object delimiter 
_2=CONTROL --> Pointplot object delimiter 
_8=CONTROL --> Polygon delimiter 
_6=CONTROL --> Pointplot polygon delimiter 
Other controls are: 
0=2|CONTROL --> Move to XY (pen up) 
1=2|CONTROL --> Draw to XY (pen down) 
1+0 100T CONTROL --> Pen type on certain terminals (Tektronix 4015) 
2=4 | CONTROL --> Point plot (move to XY and draw point) 


Each object in a graphic vector may be treated independently of the other objects, or the graphic vector may be 
manipulated as a whole. 


A limited set of APL-like functions is provided to manipulate graphic vectors, yielding capabilities such as 
SHAPE, RESHAPE, TAKE, DROP, COMPRESS and INDEX. (Group APL in workspace 3 GRAPHICS.) 
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Objects on Files 


Objects may be stored on files and a small set of functions is provided to manipulate such objects (the group 
FILES in workspace 3 GRAPHICS). Objects on files are represented by a vector consisting of a file tie number, 
followed by a vector of component numbers within that file. Most file functions append their output to the file named 
by the variable WORKFILE. 


Text - A Vector of Character Strings 


Text is represented as a vector of character strings (SV). Strings are vectors of characters or numbers, delimited by 
their first element. This allows a limited implementation of non-recursive deep generalized arrays. 


Analogous to graphic vectors, each character string (text object) is delimited by a special character - specifically the 
first character of the text vector. 


Care must be taken not to use a delimiter as part of a character string. The character following the string delimiter 
specifies the type font to be used with that string. The numbers 0 to 7 are hardware characters specific to the terminal 
in use. In most cases they are the standard APL characters. Fonts greater than 7 are the more commonly used APL 
characters supported as stroke (drawn) characters. 


120 


Terminals 


Most graphic input functions are terminal dependent. Input functions are provided for Tektronix 4000 and Hewlett/ 
Packard 2648A series crosshair input “Gin mode”, and the Tektronix 4953 graphic tablet. Most non- CRT terminals 


do not support graphic input at all. 


The following terminal types are supported (today). To condition the workspace, type: TERM 'code', where 
code is one of the codes given below. For example, when using any Tektronix 4000 series terminal, the first 
commands after signing on would be: 


)LOAD 3 GRAPHICS 


TERM "TEK! 

Terminal Code 

Any Tektronix 4000 series terminal TEK 
Tektronix 4013 TEK4O13 
Tektronix4015 TEK4015 
Anderson- Jacobson A J832 AJ 832 
Xerox Diablo model 1550 DIABLO 
Xerox Diablo 1620 DIABLO 
Xerox Diablo 1700 NEWD1700 
DTC300 DTC300 
DTC302 DTC302 
Trendata 4000 TREN4OOO 
Trendata 4000A TREN40004 
Multiwriter II ASL2 
Multiwriter III ASL3 
Tektronix 4662 Plotter T4662 
Houston Instruments Plotter HIPPO 
Hewlett/Packard 7221A HP7221 
Hewlett/Packard 9221A HP9221 
Spintronic SPIN2 
Mitek MITEKV3 





To obtain an updated list of supported terminals and their codes, type TERM ''. 


Terminal-specific strapping and setup requirements are documented in the OUTTERM function, created by successful 
execution of the TERM function. 


Supporting new terminal types is rather easy, as there is only one terminal-dependent output function (called 
OUTTERM) in the workspace. Thus, one can run the same set of functions on a different terminal by executing the 


TERM function to define the OUTTERM function necessary for the terminal in use. 


The illustrations in this manual were produced on a Tektronix 4015 with a 4631 hardcopy attachment. 
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Transforms 


Transforms (TRF) are rank-3 arrays that describe the movement and position of objects in space. Each plane 
represents a single linear transform that may be applied to a single object or to all objects in a graphic vector by use 
of the dyadic functions ZAT and AT respectively. 


For pictures in two dimensions, a single transform is a 1x3x3 array representing values of rotation, translation and 


scaling, while for three-dimensional objects it is a 1x4x4 array. Transforms may generally be combined by catenation 
along the first coordinate. Most graphic functions treat a transform as a one-element vector or scalar. 


BASIC TRANSFORMS 
Scaling: The process of shrinking or magnifying an object, and may be considered analo- 
gous to “zoom”. Scaling may take place about the coordinate origin (SCALE or 


IAS), or about a specified point (SAP). 


Rotation: The process of rotating an object about a point, either the coordinate origin 
(ROT or IAR), or about a specified point (RAP). 


The function RSAP may be used to simultaneously rotate and scale about a point. 
Translation: The process of moving objects. The functions XLATE or I AX applied to an object 
will move it in a manner analogous to “re-position”, "tilt" and “pan”. 
TRANSFORM GENERATORS 
Transform generating functions, including SCALE, ROT, XLATE and others (APPENDIX B page 
129) contains complete lists of functions) generate arrays that will scale, rotate or translate the object when 


the transform is applied. 


For example, XLATE X (where X is a scalar), will produce a transform (a 1x3x3 matrix) that can be 
applied to an object to move it X units to the right if X>O and to the left if X<O. 


SCALE S will produce a transform that will enlarge an object by S units if S>1, or scale down by 5 if 


0<S<1. COMIX M builds transforms to divide the screen into N*2 subscreens when assigned to the global 
variable CTRANS. 
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TRANSFORM APPLICATORS 


Once transforms have been generated, we need functions to apply them to graphic vectors. The functions 
are AT and IAT. AT will apply each transform to all the objects, while TAT will apply transforms to each 


object in the graphic vector one by one (itemwise). 


COMBINING TRANSFORMS 


Transforms may be combined when two or more must be applied to the same graphic vector. The first 
transform is transformed by the second, giving a combined transform to be applied to the graphic vector. 
The functions are TT (every transform on the right is applied to every transform on the left, as in 
outer-product) and ITT (itemwise) combine transforms. 


When transforms are combined they act as if they had been applied separately in the order from left to right. 


The order in which transforms are combined is important, and should be 
| SCALE-->ROTATE-->TRANSLATE. 
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APPENDIX B 


REFERENCE CARD 


INPUT-OUTPUT FUNCTIONS & OBJECT GENERATORS 


Name Syntax Description Page 
T# is text/E# example 


BOX Ä GV<BOX BX Generates boxes BX. T5,20,57,60/E60,62 
CLIP GVR+BX CLIP GV Clip GV to box BX. T63/E63,64 
DAISY GV+N1 DAISY N2 Generates daisies. T13-15,50/E13- 
15,39,51... 

- N1[ 1 ] is the number of points 

to draw. 

- N1[2] is the number of pet- 

als. 


- N2 is the radii. 


DASH GV+N DASH GV Dashed-line GV. T74/E74 
N ıs a vector of dash lengths and 
interdash spaces. 


DRAW DRAW GV Graphic output. T19,55/E everywhere 
- (N,3)=pGV : GV is clipped 
to the screen boundary and 
drawn; 


(1=ppGV)A1<pGV : DREAD, 
clip, and draw data from 
file. 14GV is file tie number, 
1+GV are components to be 
drawn; 

- (1=p,GV) : QREAD, clip 
and draw data from entire file. 
GV is the file tie number. 


DRAWINBT N DRAWINBT GV Same as: T73/E73 
DRAW N INBT GV 
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DRAWSTR 


ERASE 


FOLLOW 


FRAME 


BX DRAWSTR SV 


- ERASE 


GV+FOLLOW 


FRAME N 





Stroke characters: 

Draws stroke characters inside 
the boxes specified. 

Type fonts: 
0,1,2,3,4,5,6,7 are hard- 
ware characters; 8,9 are stroke 
characters. 


Erase screen and 

home cursor (form feed on Dia- 
blos). Useless on Multiwriter 
II. 


Interactive crosshair 

input. Draws as it goes. 

Input characters are: 

Numerics used directly as con- 
trols; 

N - New object 

P - Draw to nearest point 

L - Draw to nearest line 

C - Circular arc through 

last, current and next points. 


Screen control. 
Causes frame 
(1tpCTRANS)|N to be used 


for the next draw. 


T20,57/E20,57 


T70 


T17,53/E17,42,53 


T70/E70 


GRID 


HATCH 


IMM 


INBOX 


INBT 


MENU 


GV+GRID N 


GVR<N HATCH GV 


BX+IMM GV 


GVR+GV INBOX BX 


N INBT GV1,[1]GV2 


N<MENU SV 


Line grid. 

- N[1 2] = grid size in ele- 
ments, 

-N[3 4] = interelement spac- 
ing, default is 1 1, 

- NL5 6] = lower left corner, 
default is O O 


Cross-hatch GV. 
N[1] = Angle of lines 
N[L2] = Crosshatch spacing. 


Itemwise minimum/maximum 
Generates boxes that fit exactly 
around objects in GV. 


Scale GV to fit inside BX. 


In between. 

- (1=x/pN) Interpolate 
N-1 objects between GV1 and 
GV 2; | 

- (1<x/pN) _ Interpolate 
_1+pM objects relatively spaced 
by N. 


Select from the menu SV 


with crosshairs. WV gets string in- 
dices. 
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T66/E66 


T75/E38,75 


T65/E65-66 


T61/E61-62 


T73/E73 


T67/E68 








MO 


NEXTFR 


PEN 


POLY 


STR 


STR5 


SQPLOT 


TABLET 


TEXT 


VTEXT 


WAITCR 


WHATFR 


XIN 


GV+MO N 


NEXTFR 


GVR<GV1 PEN N 


GVR<N1 POLY N2 


GV<STR CH 


GV<STR5 SV 


GV+SQPLOT N 


GV+TABLET N 


XY TEXT SV 


GV<VTEXT SV 


WAITCR 


N+WHATFR 


GV<CH XIN N 


Make object from vector. 


Next frame. 
Switch to drawing in the rext 
frame. 


WAITCR © ERASE when 


frames are used up. 

Alter controls to pen type N. 
Generates polygons. 

N1-sided polygons of radii V2. 


Stroke characters. 
One object is produced per char- 
acter. 


Stroke characters. 
One object is produced per 
string. 


Square plot 


of vector N. 


Graphic input tablet: 
Tektronix 4953. 

N=0- point to point 

N=1- continuous (curve trac- 


ing ). 


Hardware characters. 
Hardware character text output 
at locations X, Y. 

10CH is the character string de- 
limiter, first character after each 
delimiter is the character type. 


Vertical text. 
Inserts linefeeds and backspa- 
ces. 


Wait for carriage 
return. 


Current frame number. 
Crosshair input. 
N is the maximum number of 


points; 0 is no limit. CH are ac- 
ceptable input characters. 
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T10,48/E10,48 


T71/E71 


T11,49/E11- 
12,22+ ,34,37,49,etc... 
T59/E59 


T59/E59 


T72/E72 


T18,54/E18,54 


T58,/E33,58 


T58/E58 


T71 


T72 


T16,52/E16,46,52 





TRANSFORMS 


The following diagram will help to explain some of the naming conventions adopted for transforms. 


Nouns: R 
S 
T 
X 
Verbs: A 
T 


Adverbs: (blank ) 
| I 


Rotation 

Scaling 

General transform (TRF) 
Translation 


Apply general transform 
Apply transform to transform 


Apply all transforms to all objects (outer-product ) 
Itemwise apply transform (object by object) 


foie TRANSLATE 
| GENERAL TRANSFORM 
| ©” SCALE 


ROTATE 


APPLY TRANSFORM TO TRANSFORM 
APPLY GENERAL TRANSFORM 


OUTERPRODUCTLY 
ITEMWISE 





TRANSFORM FUNCTIONS 


Name Syntax Description Page 
T# is text: Ef example 
Transform Generators 
SCALE TRF+-SCALE SCL Scale. T78,79/E78 
ROT TRF=<ROT RU Rotate. T78,80/E40,41,42,84-87 
XLATE TRF<XLATE XL Translate. T78,81/E30,31.41,84-87 
SAP TEPEXY SAP SCL Scale about point. T78,88 
RAP TRF+RAP RU Rotate about point. T78,88 
RSAP TRF<(SCL,XY) RSAP RU Rotate and scale about T78,88.79 
point. 
ID RF+ID N N-space identity T88 
transform. 
COMIX TRE<COMIX N NxN subscreen T 69.88: E69 
transform. 
Combining Transforms T83 /E84-87 
TT TRFR+-TRFA TT TRFB Transform transform. 
ITT TRFR+-TRFA ITT TRFB Itemwise transform 
transform. 
Short Forms for Transform Combinations T89 
TX TRF+-TRF TX XL = TRE<TRF TT XLATE XL 
TS TRESTREF TS SCL = TRECTRE IT SCALE SCL 
TR TRF+-TRF TR RU = TRECTRE TT- ROT AU 
ITX TRF<TRF ITX XL = TRF+-TRF ITT XLATE XL 
ITS TRECTRE TES SCL = TRF+-TRF ITT SCALE SCL 
ITR TRE<TRF ITR RU = TRE+-TRF ITT ROT RU 
Transform Applicators T82/E84-87 
AT GVR<GV AT TRE Outerproductly apply 
transform. 
IAT GVR<GV IAT TAF Itemwise apply 
transform. 
Short Forms for transtorm generators and applicators T89 


AX GV<GV AX XL = 
AS GV<GV AS SCL = 
AR GV+GV AR RU = 
IAX GV<GV IAK XL 

IAS GV+GV IAS SCL = 
IAR GV<GV IAR RU = 





GV<GV AT XLATE XL. 
GV<GV AT SCALE SCL 
GV+GV AT ROT RU 
GV<GV IAT XLATE XL 
GV+GV IAT SCALE SCL 
GV+GV IAT ROT RU 
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APL LIKE FUNCTIONS 


Name Syntax 

BEGN N+BEGN GV 
COMP GVR<B COMP GV 
DESC N+DESC GV 
DROP GVR<N DROP GV 
ISHAPE N<TSHAPE GV 
MOS GVR+MOS GV 
NDX GVR<GV1 NDX N 
NDXAS 


NDXG R<NDXG N 
OF GVR<N OF GV 
PMOS GVR<B PMOS GV 
RESHAPE GVR<N RESHAPE GV 
REO GVR+REO GV 

RMM GVR+RMM GV 
SHAPE N+SHAPE GV 

TAKE GVR<N TAKE GV 


Description 


Beginning of objects. 
Compression. 
Description of objects. 
Drop. 


Itemwise shape: 
i.e. the lengths of objects. 


Make object scalar. 


Index. 


GVR<N NDXAS GV1,[1]GV2 _ Index assign. 


(pN)=SHAPE GV2 
GVR+GV1 © GVR[N ]+GV2 


Index generator. 

N repetitions of GV. 

Integer left argument extension 
of compress. 

Partitioned MOS. 

B is a Boolean partition vector 
and (+/B)+>SHAPE GVR 
Reshape. 

Remove empty objects. 

Remove multiple moves. 


Shape of GV. 


Take, not overtake. 
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Page 
T# is text/E# example 


T93/E93 
T97/E27,97 
T93,/E93 
T99/E26,99-100 


T91/E34,91 


T98/E29,98 
T94/E94 


T95/E95 


T96/E34,96 


T96/E96 


T98/E28,98 


T92/E92 
T100/E100 
T100 
T56,91/E91 


T99/E24,25,28,29,99 100 








UTILITY FUNCTIONS 


Name Syntax Description Page 
T# is text/E# example 
AREA N<AREA GV Itemwise signed area. T102 
ARCTAN N+ARCTAN XY Arctan. T102 
N is true arctan for XY in ra- 
dians. 
CIRCLE GV<CIRCLE XY Circular arc. T102 
through 3 point in XY. 
LGRAV GVR<XY LGRAV GV Drop perpendicular line. T102 
MINA N1<XY MINA N Nearest point. T103 
MTOV SV<CH MTOV M Matrix to string T105/E105 
vector. Trailing CH are re- | 
moved. First column of matrix 
M should be delimiters. 
PERPD N<XY PERPD GV Perpendiculars to all T103 
lines. 
PGRAV N1<XY PGRAV GV Closest point on GV. T103 
PMAXSCAN N+B PMAXSCAN N Partitioned max scan. T103/E103 
PPLUSCAN N<B PPLUSCAN N Partitioned plus scan. T104/E104 
PTGRD XY+PTGRD N Translation amounts T101/E101 
for grid N. 
VTOM M<VTOM CH Matrix to vector. T104/E104 
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THREE SPACE FUNCTIONS 


Name 


CUBE 


POLY3 
SOLID 


TO2D 


VIEW 


VISIBLE 


Syntax 


R<CUBE N 


GV+N1 POLY3 N2 


GVReSOLID GV 


GVReN TO2D GV 


GVReN VIEW GV 


B+VISIBLE GV 


Description 


Exact cube. 


Three-space polygonal 
cylinders. 


Polyhedra bounded by pairs of 
objects from GV 


Convert to 2-space; 

=- N[1]= distance of viewer 
from origin, 
- N[2]= distance from viewer 
to picture plane. 


TO2D with back plane removal. 


Visibility of objects in GV. 
Clockwise traced objects are vis- 


ible. 
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Page 
T# is text/E# example 


T112/E112 


T108/E109,110,111,113 
T110/E110,112,113 


T108/E108,110,112 


T107/E109,111,113 


FILE FUNCTIONS 


Name 


DRAW 


FAT 


FBLOCK 


FIAT 


GET 


FIND 


FISHAPE 


FSHAPE 


TABTOFILE 


QCRES 


QT 


Syntax 


DRAW F 


F+F FAT TRF 


F<N FBLOCK F 


Fer PIAT JRE 


GV+GET NAME 


F<FIND NAME 


N<FISHAPE F 


N<FSHAPE F 


N TABTOFILE FNAME 


N<QCRE8 FNAME 


N<QT FNAME 





Description 


Draw - see input-output func- 
tions. 


File outerproductly apply trans- 
form. 


Data ıs reblocked to approxi- 
mately N points per component. 
Each component is a minimum 
integral number of objects, such 
that 

(1tpCOMPONENT )>N 


File itemwise apply transform. 


Find NAME and read the first 
component. 


Find NAME in the directory of 
the file library. 


File itemwise shape, i.e. lengths 
of objects. 


File shape, 1.e. number of ob- 
jects. 


Graphic tablet to file. N is the 
same as in the TABLET func- 


tion. 


Similar to QT but creates 
FNAME if it doesn’t exist. 


N gets tie number of FNAME. If 
not tied, LISTIE FNAME. 
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Page 
115 


GLOBAL VARIABLES 


Name Description 

CTRANS COMIX and subscreen transforms. 

DEGR Conversion factor from degrees to radians. 

OD Object delimiter. 

PD Polygon delimiter. 

SMTRANS Terminal-dependent transform. 

SV Terminal state vector and various constants. 
TRANS User space to unit radius, origin centred transform. 
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